libURLFormData

Type

function

Summary

libURLFormData formats data in the standard format suitable for sending to form processing CGIs and other processes on a web server.

Syntax

libURLFormData(<key1>, <value1> [, <key2>, <value2> ...])

Description

The function accepts variable numbers of parameters and treats them as key-value pairs. The first parameter is the name of the first form part, the second the value of the first part, the third is the name of the second part, and so on.

note

The Content-Type header is set to "Content-Type: application/x-www-form-urlencoded" by default when using post. There is no need to set the httpHeaders unless you have previously set the Content-Type header to something else.

Important

The libURLFormData function is part of the Internet library. To ensure that the function works in a standalone application, you must include this custom library when you create your standalone. In the Inclusions pane of the Standalone Application Settings window, make sure the "Internet" script library is selected.

Parameters

Name	Type	Description
key1
value1
key2
value2

Examples

put "John" into tName
put "Hello" into tMessage
get libURLFormData("name", tName,"message", tMessage)
post it to url "http://www.someserver.com/cgi-bin/form.pl"
-- In this case, the data posted to the url will look like this: name=John&message=Hello

Related

function: libURLMultipartFormAddPart, libURLMultipartFormData

glossary: application, standalone application, function, main stack, keyword, group, Standalone Application Settings, message, handler, LiveCode custom library

library: Internet library, library

message: openBackground, openStack, startup, preOpenStack, preOpenCard

command: post, libURLSetExpect100

Compatibility and Support

Introduced

LiveCode 2.5

OS

mac

windows

linux

web

Platforms

desktop

server